home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / util / misc / FastFontList.lha / FastFontList.readme < prev    next >
Encoding:
Text File  |  1997-10-16  |  4.2 KB  |  123 lines
  1. FastFontList 1.0
  2. By Matt Hey matthey@hotmail.com
  3. (11.10.97)
  4.  
  5. REQUIREMENTS
  6.  
  7. An Amiga
  8.  
  9.  
  10. RECOMENDED
  11.  
  12. A lot of fonts
  13. Programs that use fonts
  14.  
  15.  
  16. DESCRIPTION (What is it?)
  17.  
  18. FastFontList is a cache program for FONTS: font listing. In most cases it speeds
  19. up font requesters and font scanning. It is useful to Amiga owners with many
  20. fonts in their FONTS: and isn't much use otherwise. It SetFunctions (patches)
  21. the AvailFonts function in the diskfont.library and remains resident in memory.
  22. It has no GUI or interface; just run it to make font requesters faster.
  23. FixFontList is a program that comes with FastFontList and is used to make an up
  24. to date cache for FastFontList to use. It must be run before FastFontList or no
  25. speed increase will be seen.
  26.  
  27. Advantages...
  28. 1. very fast font listing of FONTS:
  29. 2. works with the ASL font requester (and more)
  30. 3. saves CPU cycles when listing large FONTS: and sleeps otherwise
  31. 4. less memory is required to list a lot of fonts (yes, it's true)
  32. 5. doesn't fragment memory much
  33. 6. should work on any OS version and any 68k processor (not tested)
  34.  
  35. Disadvantages...
  36. 1. not needed with few fonts
  37. 2. only works with programs that use the AvailFonts function
  38. 3. no speedup with less used (new) AvailFonts flags
  39. 4. requires ~1.5k of memory all the time to have installed
  40. 5. requires at most 46 bytes per font of disk space in FONTS: (often much less) 
  41. 6. FixFontList should be run after adding or deleting fonts 
  42. 7. the stack requirements are different with FastFontList installed
  43.  
  44.  
  45. INSTALLATION & USAGE
  46.  
  47. Sorry there isn't any install script.
  48.  
  49. Move FastFontList to the WBStartup Drawer. Move FixFontList to a permanent
  50. location (maybe the System drawer?) somewhere else. Double click on FixFontList
  51. once and then every time a font is added or deleted from FONTS:. FixFonts should
  52. be run before FixFontList if necessary. Wait for FixFontList to finish and then
  53. reboot or double click on FastFontList
  54. to activate.
  55.  
  56. For advanced users and old OS versions...
  57. Run >NIL: in the S:user-startup works too.
  58.  
  59. Do NOT run FastFontList twice!
  60.  
  61. Remove FastFontList from the WBStartup drawer and place somewhere else to
  62. disable permanently after the next reboot.
  63.  
  64. Send a Ctrl-C to FastFontList to remove from memory. Do NOT do this while
  65. listing fonts!
  66.  
  67. Along with FastFontList and FixFontList, the _FontList file should be
  68. deleted from FONTS: when uninstalling.
  69.  
  70.  
  71. TECHNICAL
  72.  
  73. FastFontList SetFunctions the diskfont.library AvailFonts function. When
  74. AvailFonts is called and the flags are acceptable, the file FONTS:_FontList is
  75. loaded which contains the information about the fonts on disk. In memory fonts
  76. are added if requested. If AFF_Tagged, AFF_Bitmap or any unknown flags are set
  77. then the function is passed through to the old AvailFonts function but offers
  78. no speedup. Likewise, if disk fonts are not requested then the request is passed
  79. through to the old Availfonts function.
  80. FixFontList simply calls AvailFonts with the AFB_Disk flag set and writes to
  81. FONTS:_FontList the size of the returned data that follows and then the data.
  82. Unused space is removed when writing.
  83.  
  84. FastFontList and FixFontList are written in Assembler. Both are pretty well
  85. optimized and not much would be gained by optimizing for specific processors.
  86. If you must see the source code or need it then e-mail me. Also, both programs
  87. should be system friendly (i.e., pass all debugging tool tests). If any bugs are
  88. found, please e-mail me.
  89.  
  90.  
  91. BUGS
  92.  
  93. Bugs:
  94. None known. E-mail me if you find any.
  95.  
  96. Quirks:
  97. Running FastFontList twice SetFunctions AvailFonts again (shouldn't crash though)
  98. FastFontList could be more tolerant of corrupt FONTS:_FontList file
  99. Quitting FastFontList can cause a crash if listing fonts (SetFunction's problem)
  100. AFB_Scaled is ignored when listing diskfonts (I don't think it would ever matter)
  101.  
  102.  
  103. DISTRIBUTION
  104.  
  105. FastFontList and FixFontList are free. Please include the docs when
  106. distributing. Please send bug reports to me.
  107.  
  108.  
  109. HISTORY
  110.  
  111. This is version 1.0 and is the first version released.
  112.  
  113.  
  114. CREDITS & THANKS
  115.  
  116. I would like to thank the following people...
  117.  
  118. Chris Williams for giving me the idea to do this project
  119. Frank Wille for his great assembler & linker (PhxAss & PhxLnk)
  120. Amiga freeware/PD authors
  121. Amiga supporters
  122. Anyone able to resist the "Dark Side" (Microsloft)
  123.